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PREFACE 


The Batch User's Guide describes the PDP-11 Batch operating 
system. The manual is organized into four chapters, augmented by 
five appendixes. 

Chapter 1, "How to Use Batch" is directed primarily to 
FORTRAN programmers, who require information on how to prepare a 
job for Batch execution; and to the operator, who must know how to 
invoke Batch, and how to communicate with the system. Basic informa- 
tion is provided on the Batch Command Language; i.e., only those 
commands essential to executing a job are described ($JOB, $EXECUTE ^ 
$RUN, $FINISH) . A brief glossary is also provided. Little or no 
knowledge of DEC software is required to understand and use Batch, 
as it is described in Chapter 1. 

Chapter 2, "Batch Command Language", covers the entire comple- 
ment of commands used in Batch. The reader of Chapter 2 will 
benefit from familiarity with the PDP-11 Disk Operating System* 


Input/output is discussed in Chapter 3. Again, a knowledge of 
DOS is assumed. 

Chapter 4 is directed to programmers who are responsible for 
writing, or modifying programs that are used in conjunction with 
Batch. 

The appendixes provide useful information related to Batch; how 
to use the CRll Card Reader, special punches for end-of-file and 
brackets, and, how to use the LPll Line Printer. 
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NOTATION CONVENTIONS IN THIS MANUAL 


Brackets [ ] - brackets are used to enclose optional 

elements; e.g., FI [NISH] - indicating 
that the letters NISH may be omitted at 
the user's discretion. The brackets are 
not part of the command. 

Note 

An exception to the use of brackets is in con- 
junction with the user identification code. 

The brackets are required, and must appear as 
part of the statement; refer to Chapter 1, 

Section 1.1.2. 

Delta A - the A character is used to denote "space", as 
in "fileAname," which means that "file" and 
"name" must be separated by a space. 

Braces { } - braces are used to enclose two or more 

elements, from which a choice must be made. 

For example 



means that either a space or a comma must 
appear in the position. 
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SOFTWARE SUPPORT CATEGORIES 


Digital Equipment Corporation (DEC) makes available four categories of software. These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 

The four categories are as follows: 


CATEGORY I 

Software Products Supported at no Charge 

This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category I to 
Category il for a particular customer if the software product has been modified by the customer 
or a third party . 


CATEGORY II 

Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC , 


CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
pre-release software to internal, non-competitive applications. Category 111 software Is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 


CATEGORY IV 
Non - Su ppor ted Software 


This category includes all programs for which no support is given 
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CHAPTER 1 


HOW TO USE BATCH 


1 . 1 INTRODUCTION 


This Chapter contains the basic information required to pre- 
pare a job for execution by the PDP-11 Batch operating system. The 
information is intended primarily for those users programming in 
FORTRAN, who wish to submit a job to be run under Batch. While 
the input medium is assumed to be the card reader in the follow- 
ing examples. Batch supports a variety of input devices: disk, 
DECtape, magnetic tape, or paper tape (refer to Table 1-2). 

Batch includes a disk-resident Monitor, and a number of system 
programs (such as the FORTRAN Compiler) . The Monitor controls exe- 
cution of user jobs, by reading and interpreting batch command state - 
ments the user has placed in the input deck. Several jobs can be 
processed sequentially by Batch, each job set apart from its neigh- 
bors by delimiters that define its starting and ending points. The 
sample job shown below consists of a FORTRAN program to be com- 
piled, linked,^ and executed. 



^ Linking is the process of producing an executable program from one 
or more separately compiled or assembled programs. The inputs to the 
Linker are called "object" modules; the executable output of the 
Linker is called the "load" module. 
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The function of each Batch command card shown in Figure 1-1 
is defined as follows: 


$JOB MATX 
$EXECUTE 

$EOD 

$FINISH 

End-*of file 
card 


Identifies the start of the job, and 
assigns the job’s name (MATX) • 

Calls the FORTRAN compiler, and causes 
the program to be compiled, linked, and 
executed. 

Acts as a logical data delimiter, sepa- 
rating the source program from the 
program’s data cards. 

Identifies the logical end of the job. 

Identifies the physical end of the job. 

It contains a 12 11 ^ 1 6 7 8 9 in column 
1; see Figure 1-2. (A "12” punch is the 
character & ((3^29 code) or a plus ( + ) 

(026 code) . An "11" punch is the minus 
(-) for either code.) 


Certain commands (i.e. , $JOB, $RUN, $CHANGE, $GET, $FINISH) are 
printed at the keyboard as they are read from the card reader. The 
card is echoed in its entirety, up to and including column 80. 
Therefore, to eliminate needless echoing of trailing blanks, put a 
"blank suppress" card at the front of the deck. This card has a 
punch of 12 11 0 7 8 9 in column 1. 


Sequence numbers may be punched in columns 73-80, as a means 
of keeping the deck in its proper order. The contents of columns 
73-80 are not significant to Batch. 


? 2 3 i 5 B ? 8 9 10 M Tz 11 M ’"s "s ^7 '"b ’9 20 z” 2*2 z'l 24 25 26 27 28 29 30 3? 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 58 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 

I ] 1 1 11 11 1 i n 11 n 11 n I n n 11 n n 11 1 1 n ] 1 n 1 n 1 11 11 n 1 1 1 1 1 1 D I ! ii 1 1 11 1 1 1 1 11 1 n 1 1 1 1 
inininininniniuniiunnuiiuiuininiiiniuuuuiiuniiinuinii 

33333333333333333333333333333333333333333333333333333333333333333333333333333333 

4444U 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 M 4 4 4 4 M 4 4 4 04MU 4 4 4 4 M 4 4 4 4 4 M4d^ii^ 

5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 b b 5 S b 5 5 5 5 5 5 5 S 5 5 5 5 5 5 5 5 5 5 5 3 

1 6 6 6 6 S 6 6 6 6 6 6 8 6 6 6 G 6 6 B 6 6 6 6 6 G 6 6 6 6 6 6 6 6 6 6 8 6 6 6 6 6 6 B 6 6 6 6 6 6 6 6 B E B 6 6 6 B 6 e 6 6 5 6 6 6 6 6 6 6 6 E B 6 E D 6 E 6 

177 7777 7777777777 777 n7777777777777777777/77777/7J777?77777?777n 7/777/77 77777/7 


1999999999999999 99999999999999999 99999999999 S999999999999999999 99 99 99 99 99 9999999 
" 2 3 4 5 6 ? 8 9 10 111213 14 1516 1718 IS 20"! 22 23 24 25 26 27 28 28 3' *1 32 33 34 35 36 37 38 39 40 41 47 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 73 BC 


Figure 1-2 Fnd-of-file card 
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When the $EXECUTE command is used, the Batch system determines 
the input and output specifications for the FORTRAN compiler. Thus, 
in the sample deck shown in Figure 1-1, the object program is out- 
put to the system device, the source listing is output to the line 
printer, and the source program is read in from the batch stream. 

The user can include input/output specifiers with the $EXECUTE state- 
ment ^ or he can use the bR.UN Gommand instead of Sexecutf . "Pol 
by a command string. The command string consists of the input/ 
output specifications, and is distinguished by having a # char- 
acter in column 1. Figure 1-3 shows a typical command string. 

Note the "/GO" at the end of the # card - this is a switch that 
causes the FORTRAN program to be compiled, linked, and executed, 
just as though the $EXECUTE command had been used. 



Figure 1-3. Use of /GO Switch 

The "less than" symbol (<) separates the output specifications 
from the input specifications. 

In Figure 1-3, the output is specified as: 

i^ATX - object program (file name MATX; the extension 
.OBJ is assigned by default) ; 

LP: - the line printer will be used to list the source 

program. 
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The input is: 


BI: - the source program comes from the batch 

stream (BI) ? 

/GO - the /GO switch causes the program to be 
compiled, linked, and executed. 


The user also has the option of specifying each step of a job's 
processing. For example, he may wish to have the system generate 
a dump in the event of a fatal error in his program. To do so, he 
must include Batch Command Language cards at each step of the job. 

As shown in Figure 1-4, the dump is specified on the $RUN 
MATX/DU card, by the switch, /DU. Optionally, this switch could 
have been used on the $RUN FORTRN card, in which case, the /GO switch 
could have been specified in the subsequent command string. The deck 
set-up would then duplicate that shown in Figure 1-3. A dump would 
be generated for a fatal error occurring during FORTRAN compilation, 
linking, or program execution. The dump linkage would be core- 
resident for the entire duration of the job. 



Figure 1-4 Batch Job Set-up with 
User-Specified Job Steps 

Table 1-1 defines the function of each BCL card in the 

deck. 
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TABLE 1-1 


Key to Card Deck in Figure I -4 


$JOB MATX 

Defines the starting point of the job; 
and gives the job name, MATX. 

$RUN FORTRN 

Causes the FORTRAN Compiler to be 
loaded and executed. 

#MATX,LP:<BI: 

Command string defining the FORTRAN 
Compiler's input and output datasets. 

Note that the GO switch is omitted. 

FORTRAN Source Deck 

The cards comprising the source pro- 
gram, MATX. 

$RUN LINK 

Causes the Link-11 Linker to be loaded 
and executed. 

fMATX , LP : <MATX/CC , FTNLIB/L/E 
(See note.) 

Defines the Link-11 load module to be 

MATX; the Map output to be on the line 
printer; and the object modules to be 

MATX (the output of the FORTRAN Com- | 

piler) and FTNLIB, a Library routine | 

(as indicated by the /L switch) . The /E | 
switch signifies "END" of Linker input. 

$RUN MATX /DU 

Causes the linked program, MATX, to be 
loaded and executed. The /DU is a "DUMP" 
switch, requesting that the program be 
dumped if an error occurs. 

DATA FOR MATX 

Data to be used during program execution. 

$FINISH 

The $FINISH card is the end-of-job de- 
limiter; it designates the logical end 
of the job. 

End-of“File 

: This card physically delimits the job. 

The operator must place one of these 
cards at the end of each job. As a 
further safeguard, the user should put one 
as the first card in his deck, to pro- 
tect himself from a preceding job's 
erroneous execution. Eight consecutive end- 
of-file cards terminate the batch stream. 


NOTE; The /CC switch CConcatenatel must be used, if the source 
deck comprises more than one main program or subroutine 
in a concatenated deck. The /CC tells the Linker that the 
object module contains concatenated modules. It is 
recommended that the /CC switch be used for all compiled 
object modules input to the Linker. 
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1.1.1 Terminology 


batch stream 

batch stream device 

BCL 

dataset 


file 


job 


Linker 


load module 
log 


object module 


overlay 


The sequence of statements (command or data) 
comprising the job(s) to be processed by 
Batch 

The input device from which Batch reads the 
batch stream. 

Batch Command Language. The set of state- 
ments used to direct the execution of a job. 

A logical collection of data which is 
treated as a discrete entity by a pro- 
gram. A "dataset" can consist of data from 
a physical device, a file name (and op- 
tional extension) ; it may be a program, an 
object module, a load module, etc. 

A physical set of data referred to by name. 

A file can be a card deck, or a name and 
collection of data residing on a disk, or 
DECtape . 

The work to be done, delimited by a $JOB 
card and a $FINISH card. A job can con- 
sist of one or more programs. 

A system program that takes one or more 
independently compiled programs as input 
and creates a single program that can be 
loaded and executed. The linked program 
is called a load module . 

The output of the Linker program, in load 
format. 

The record of a job*s processing; consist- 
ing of command statements processed, error 
messages, etc. 

The relocatable binary output of a com- 
piler or assembler. Input to the Linker 
program. 

A file, residing on a backup storage de- 
vice (such as disk or DECtape) , that com- 
prises a portion of a program. Overlays are 
brought into core, as needed, thereby allowing 
a large program to run in a small core area, 
by "overlaying" an area in core (refer to 
Link-11 Linker and Libr-11 Librarian Pro- 
grammer's Manual). 
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1.1.2 Job Definition 


$JOB card identifies the start of a job, and permits the user to 
supply information pertinent to its execution. This card is formatted 

$JOB jobname [uic] /swl/sw2 [,log dataset] 


where: 


jobname is specified by the user to assign a name 

to his job. This field consists of one or 
more letters or digits. The jobname could, 
for example, be the user’s name (to help 
identify the destination of the log) . Only 
the first six characters are used by the 
system. (The whole name is placed in the 
log, however.) If omitted, the job name 
is given a default value by Batch. (The 
first default job name is 000001 ^ the next 
is 000002 , etc. Defaults are assigned in 
numerical sequence. Each time a Batch 
session is started, the default sequence 
is reset. 

[uic] is the field in which the user identifies 

himself, by means of the "user identifica- 
tion code". This field is delimited by left 
and right brackets. The left bracket is 
multi-punched as either 12-8-2 [029 code) 
or 11-8-5 [026 code) ; the right bracket is 
either 11-8-2 (^9) , or 12-8-5 (J2(26).^ The 
format of the uic field is 

[nnn, nnn] 

where the nnn value to the left of the com- 
ma is an octal number identifying the user- 
group to which the user belongs, and the 
second nnn value identifies the particular 
user within that group. Thus, if the user 
has been assigned as user 27 within group 
34, he would enter [34,27] for [uic]. 

If the uic is omitted, the default uic 
which is set by the system manager, is 
used. If the default uic is 0 , the job is 
not run. 


^ A punch in the 12 row is & [ 029 ) or + [ 026 ) ; an 11 punch is - for 
either. See Appendix B. 
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/ swl is a switch used to set a limit on how 

long the job is permitted to run. It is 
formatted as: 

/TI :hh:mm 

where hh and mm are specified as decimal 
integers for hours and minutes respect- 
ively. If no time limit is provided, the 
BATCH command value is assumed. A value 
greater than that specified in the BATCH 
command is ignored (see 1.3. 1.2). If only 
one value is supplied, it is assumed to be 
"minutes" (see sample job card, below) . 

/ sw2 is the switch that allows the user to sup- 

press the log, a record of the job's execu- 
tion. If /NL is specified for /sw2 , no log 
(record) is produced of the job control 
statements processed during the job's execu- 
tion. If /NL is omitted, the user will get 
this record as part of his output. The de- 
vice used for the log is specified in the 
BATCH command. (Refer to 1.3. 1.2.) 

NOTE 


Switches can appear in either order; 
e.g., /NL/TI:i3f5 


log dataset is an optional entry, which specifies the dataset 
used for the log for this job. It overrides the 
log dataset specified in the BATCH command. 


SAMPLE JOB CARD 

$JOB MATX[34,27]/TI:15,DT1:L0G 
job name - MATX 

user identification code - user group 34, user 27 
time limit - 15 minutes 

log - put the log on DEC tape 1, under file name LOG 
1.1.3 Compilation 

To compile a program, the user must place a $RUN card after the 
$JOB card. The $RUN card is a command to the Monitor to load and ex- 
ecute the compiler. 

Format: 

$RUN FORTRN 

(For information on using MACRO-11, the PDP-11 assembler, refer to 
Section 1.3.3.) 
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Following the $RUN card, place a command string card defining 
the input to, and output from, the compiler. 

Format : 

#dev: obj- file , dev : list-file<dev: source- file 

where: 

#_ (number symbol) occupies column 1; 

dev specifies the device to which the dataset 

is assigned (refer to Table 1-2) ; 

ob j-f ile specifies the file name and extension of 

the object-code file; 

list-file specifies the file name and extension of 
the source program listing; and, 

source-file specifies the input file containing the 
source program to be compiled. 
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TABLE 1-2 


Standard Peripheral Devices 


Name Mnemonic 

Disk 

DC 


DF 


DK 

DECtape 

DT 

Line Printer 

LP 

Magtape 

MT 

Paper Tape Punch (High-speed) 

PP 

Paper Tape Reader (High-speed) 

PR 

Low-Speed Punch and Reader 

PT 

Keyboard 

KB 

Card Reader 

CR 

Batch Input 

BI* 

System Device 

SY* 


*This is a "pseudo-'device" • Refer to Section 1.1. 3.1. 
ComiTLand String Example 


#MATX,LP:<BI: 


The result of the above specification is: 

- the object module is placed on the system device, under file 
name MATX.OBJ (OBJ is the default extension) ; the system de- 
vice is the default output device. 

- the listing of the source program is put on the line 
printer; 


- the source program is read from the batch input device 
(BI) , beginning with the next card in the stream. 
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Use of Pseudo-Device Specifiers (BI^ SY) 


By specifying BI as the input device, the user achieves device- 
independence; the source program is read from the batch input device, 
regardless of what the device may be. This feature of Batch per- 
mits the same control card to be used without concern for which de- 
vice uiie Daccn scream may De read. rrom. 


To specify that the system device is to be used, when the actual 
device is not known, specify SY. The system will supply the correct 
device for SY. 

1.1, 3. 2 FORTRAN Logical Units 

The BI pseudo-device specifier is assigned to logical unit 8 

in the FORTRAN device table. Logical units 1, 2, 3, and 7 refer to 
the SY specifier. 

Examples : 


READ (8,23) A, B, C (read from BI) 

WRITE (1,15) (write to SY - 2, 3, or 7 in place 
of 1 also specifies SY) 


The $ASSIGN command can be used to override the default values; 

e.g . ; 


$ASSIGN BI:,4 

Logical unit 4 is assigned to the batch stream dataset. 

1.1.4 Linking 

Object modules are linked into an executable program by the 
Link-11 program. Link-11 is invoked by the corrimand: 

$RUN LINK 

This card must be inserted in the deck, following all source 
input to the compilation. The $RUN LINK card must be followed by a 
command string that specifies Link-11 's input and output. 
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The command string has the following format: 


#load module output, map output < object modules /E (or /GO) 

The object modules are the inputs to Link-ll which are linked 
into the load module; the program that is to be executed. A load map 
may be obtained, which provides information on the load module 
(transfer address, high and low limits of the relocatable code, etc.) 
Details are provided in the Link~ll Linker and Libr-11 Librarian 
manual . 

Link Example 

#MATX,LP: <MATX,FTN.LIB/L/E 

The two input modules specified are MATX (the Compiler’s output), 
and FORLIB, which is a library module. (OBJ is the assumed extension 
of the input modules.) The load module is output to the system 
device, under the file name MATX.LDA. 

1.1. 4.1 Creating Overlays in Batch Mode 

The overlay facility is described in the Link-11 Linker and 
Libr-11 Librarian manual. To use this facility in Batch, the user 
supplies a sequence of command strings, defining the resident por- 
tion and each overlay, in the manner shown in the following example: 

#RES,LP:<RES.OBJ/OV: 2,FTNLIB [1, 1]/L/E 
#0VL1 , LP : <0VL1 . OBJ , FTN.LIB [1,1] /L/E 
#0VL2 ,LP : <0VL2 .OBJ ,FTiNLIB [1 , 1] /L/E 

The "0V:2" switch in the first command string specifies that 
the next two links are overlays. The user supplies a value of /OV 
corresponding to the number of overlays. Refer to the Link-11 
Linker and Libr-11 Librarian manual for details. 


1.1.5 Program Execution 


To execute a program, the user provides a $RUN statement 



specifyirxg the name of the program he wishes to be executed and the 
input device on which the load module resides. 

$RUN progname [uic] /switch 

The switch that can be specified with the RUN command allows a 
dump to be taken should an error occur, providing the user with a 
debugging tool. In the example below, the core area for which the 
dump is requested is the area occupied by the user's program. Options 
are available to specify that all of core, or an area bounded by 
user-specified addresses, be dumped. (Refer to Chapter 2, "$RUN" 
command . ) 

Program Execution Example 
$RUN MATX/DU 


This example illustrates how a program named MATX would be 
executed (from the system device) . In the event of an error, the 
program area would be dumped. 


1.1.6 Summary of Job Preparation Steps 


1. $JOB card, to denote the start of the job. 

2. $RUN FORTRN (to invoke the compiler), or $EXECUTE. (Cards 
3,5,6, not used with $EXECUTE.) 

3 #MATX, LP : <BI : Cttie command string defining compiler s input 

and output). If /GO switch is specified, cards 5,6 not used 

4. Source cards; the FORTRAN source program. 

5. $RUN LINK (to load and execute the Link-11 program) . 

6. #MATX,LP:<MATX,FORLIB/L/E (the command string defining the 
object modules, load module, and map to the Link-11 program) . 

7. $RUN MATX/DU (load and start the program MATX; dump^ the 
program area if an error occurs) . Replace with $il 0D if card 
2=$EXECUTE; or /GO switch used with card 3. 

8. Data cards. 

9. $FINISH (to delimit the job, logically). 

10. End-of-file card (physical end-of-job) . 

This is only needed when the card reader is the batch 
stream device. This sequence of cards is _ repeated for each 
job to be processed during the Batch session. 
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1.2 BATCH COMMAND LANGUAGE 


The user communicates with the Batch Monitor through Batch 
Command Language (BCL) statements. To prepare a FORTRAN 
job for execution, he must include statements to: 

a. Define and delimit the job; 

b. Effect compilation of source code; 

c. Link object modules; and, 

d. Execute the program. 

Batch Command Language statements directed to the Monitor, must 
observe the following rules ; 

1. A dollar sign ($) must appear in column 1; 

2. The statement identifier must immediately follow the 
$, starting in column 2. 

3. The statement identifier is terminated by a comma or 
a space. Therefore, neither of these characters can 
appear as part of the identifier. 

The $EXECUTE command, previously discussed, is one of the BCL 
commands referred to as "concise commands". They are called concise 
commands because they allow the user to invoke whole sequences of 
commonly-used functions with a single command, instead of two or more 
otherwise required. Concise commands are simimarized in Table 1-3. 

The full complement of Batch commands are described in Chapter 2. 
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TABLE 1-3 


Batch Concise Commands 


Name 

Function 

$CPY 

Copies a file, or files, onto a specified output 
dataset. 

$DEL 

Deletes specified datasets. 

$DIR 

Obtains a directory listing. 

$EX[ECUTE] 

Causes a source program to be compiled (or assem- 
bled) , linked, and run. 

$FORTRN 

Compiles a source program, producing an object 
module and a listing (a listing can be produced, 
with no object module, if desired). 

$LINK 

Links object modules into an executable load module, 
and generates a load map. 

$LIST 

Prints datasets on the line printer. 

$MACRO 

Assembles a source program into an object module, i 
and produces a listing; or, if specified, produces j 
only a listing. j 

$RNM 

Renames a dataset. j 
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CPY 

1.2.1 $CPY 

Function - Copy input dataset (s) to an output dataset. 

Form - $CPYA input dataset (s) A TO A output dataset. 

Input - At least one dataset must be specified? more than one 
may be specified Two or more input datasets are 
concatenated into one output dataset, if the output is 
a named file. Otherwise, they are separate. (Refer 
to the PIP manual.) 

Output - One, and only one dataset, must be specified. 

Examples 

1 . $CPYAdT2 : * . OBJ ATOASY : 

All files with extension OBJ, residing on DECtape unit 2, are 
copied to the system device. 

2 . $CPY ADKl : FIL . EXT [3,17] ATO AMT2 : NUFIL . EXl 

The file, on RKll disk unit 1, FIL. EXT (belonging to user 17 
of group 3) is copied to magnetic tape unit 2. The name of the copy 
on magnetic tape is NUFIL. EXl. 


1-16 



DEL 

1.2.2 $DEL 

Function - Deletes specified datasets. 

Form - $DELA dataset [,dataset2 , . . . datasetn] 

At least one dataset must be specified. if no device is speci- 
fied, the system device is assumed. If a device is specified, it 
is assumed for following datasets that do not have device specifiers, 
until a device is specified. 

Examples 

1. $DELAA 

A file named A is deleted from the system device. 

2 . $DELADT1 : FILA . FTN , DKl ; FLE .MAC , FLA . FTN 

FILA.FTN is deleted from DECtape unit 1? FLE .MAC and FLA, FTN 
are deleted from RKll disk unit 1. 

3. $DELA*.MAC 

All files with extension MAc are deleted from the system device. 
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DIR 


1.2.3 $DIR 


Function - Obtain a directory listing. 

Form - $DIR[[Ainput dataset (s )] ATOA [output dataset]] 

Input - One or more input datasets can be specified. If omit- 
ted, the directory obtained is that of the user who is 
currently logged in. The default device is the system 
device . 

Output - The default device is the keyboard. 

Examples 

1. $DIR 

The current user's system device directory is printed at the 
keyboard. 

2. $DIRADF: 

The current user's RFll disk directory is printed at the key- 
board. 

3 . $DIRADT1: ,DK: [3,5] ATOALP: 


The current user's directory on DECtape unit 1, and user [3,5] 's 
directory on the RKll disk, are printed at the line printer. 


4^ $DIRATOALP: 

The current user's directory, on the system device, is printed 
at the line printer. 

5 ^ $DIRA* . OBJ ATOALP : 

A directory listing of all files with extension OBJ that belong 
to the current user, and that reside on the system device, is printed 
on the line printer. 


i 


1-18 



EXECUTE 


1.2.4 $EX[ECUTE] 


Function - Compiles a source programi, link the object m.odule, 
and runs the resulting load m.odule. 

omary 

Form - $EX[ECUTE] A [source dataset] [ATOA [dataset] [.listing]]] 

Input - The source program is assumed to be FORTRAN. The 

FORTRAN compiler is invoked to compile the source code 
specified in the "input dataset." 

If the source dataset is not specified, the source 
program, is assumed to follov/ the $EXECUTE statement in the 
batch stream. An $EOD statement is required to signal the 
end of source input and the beginning of data. 


Output - If the binary dataset, and/or the listing dataset, 
are omitted, the object and load modules are tempo- 
rary files on the system device, and the listing 
is produced at the line printer. Otherwise, the 
object and load modules are produced as specified; 
i.,e., the load module assumes the object module*s 
file name, with extension .LDA. 


Examples 


1. $EXECUTE 


The FORTRAN compiler is loaded and run. The source program, 
is read from the batch stream. The object module is output to the 
system device, linked into a load module, and run. The listing is 
printed at the line printer. 
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2 . 


$EXECUTEAPROG 


The FORTRAN compiler is loaded and run, to compile the 
source program, PROG, from the system device. Linking and 
execution follow. 

3 . $EXECUTE DTI : ABC . CBAATO ADK : ABC , LP : 

The FORTRAN compiler is loaded and run. An object module 
(ABC. OBJ), and load module (ABC.LDA) are produced and placed on 
the RKll disk. The load module is run. The listing is produced 
at the line Printer as requested. 
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1.2.5 $FORTRN 


FORTRN 


Function - Load and run the FORTRAN compiler, to compile 
source input dataset (source) and produce 
a binary output dataset and listing. 

Form ” $FORTRNfA [input dataset ] ATOA [obj ect dataset ][, list ]”1 

Input - If omitted, the source program is assumed to 
follow immediately in the batch stream. 

Output - The object dataset, if omitted, goes to the 

system device, with the file name specified in 
the input dataset. If no input file name was 
given, the object module assumes the job name. 

The extension is .OBJ. The listing goes to the 
line printer, if defaulted. 


Examples 


1 . $FORTRNAABC ATOAXYZ , DTI : SRC 


The source program, ABC, is read from the system device, and 
compiled, producing an object module. The object module is output 
to the system device, with the name XYZ.OBJ. The listing dataset 
goes to DECtape unit 1, with the name SRC.LST (LST is the default 
extension) . 


2 , $FORTRNADK : ABCATOASY : ABC 

The source program ABC.FTN is read from the RKll disk, and 
compiled; the object module goes to the system device, under the 
ABC. OBJ; the listing is produced at the line printer, by default. 

3. $FORTRNAABC 

The source program, ABC, is read from the system device. 

The object module ABC. OBJ goes to the system device by default, 
and the listing is defaulted to the line printer. 
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4 . 


$FORTRN 


The source program is read, immediately following in the batch 
stream (i.e., BI : is assumed). The binary object module is put 
on the system device with the listing at the line printer, both 
by default. 

5 . $FORTRNAAATOA , LP : 

The effect is to generate a listing, at the line printer, but 
no binary dataset. 
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1-2.6 $LINK 


LINK 


Function - Invokes the Link- 11 program, to link input data- 
sets (object modules) into an output load module, 
and produce a load m.ap. 


i^orm - 


^jjj-HKLxnput. da ta &er. V y L^r\ja[xcaG 


,, 1 1 r ^ j TV-.- v-,1 1 


Input - At least one input dataset is required; more than 
one can be specified. File characteristics, such 
as concatenated object modules (/CC) or library 
modules (/L) , must be defined by the user (refer 
to Link-11 Linker and Libr-11 Librarian manual) . 


Output - Same as $FORTRN, except that the load module exten- 
sion is .LDA, rather than .OBJ. 


Examples 

1 . $LINKAA , FTNilB/L 


The object module. A, is linked with library routines from 
FORLIB, producing a load module (A. LDA) and a load map. The input 
comes from the system device (by default) ; while the load module 
and load map are output to the system device and the line printer, 
respectively, by default. 


2 . $LINK ADF ; A , DTI : FTNXIB/L ATOASY : ABC , LP : 

The object module, A. OBJ is input from the RFll disk, and 
linked v.-ith routines from FORLIB. OBJ, input from DECtape unit 1. 
ihe load module, ABC. LDA, is output to the system device; the load 
map is produced at the line printer 
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LIST 


1.2.7 $LIST 


Function - Print datasets on the line printer. 

Form - $LIST [ Adatasetl, . . . , datasetn] 

Input - If no datasets are specified, the dataset immediately 
following in the batch stream is printed on the line 
printer. 

Output - Line printer only. Never specified. 


Examples 


1. $LISTADK:A.FTN,B.FTN,DT1:Z.FTN 

Three datasets are printed at the line printer; 
DKiA.FTN, DK:B.FTN, and DT1:Z.FTN (DK: carries as the 
device specifier, until a different device is specified. 
If no device is specified, SY: is assumed.) 

2. $LIST 

The dataset immediately following in the batch stream 
is printed. 
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MACRO 


1.2.8 $MACRO 


Function - Assembles source input, producing an object module 
and a listing as output. 


A T T-srMTH =s 4 


s Gii** f a 


) ^TOA [object dataset] [-listing dataset^ 


Input - At least one input dataset is required; two or more 
can be specified. The MACRO- 11 assembler assembles 
multiple input datasets together, creating a single 
object module. 


NOTE 

Input to the MACRO-11 assembler must be 
from a mass storage device. Source programs 
on punched cards must be copied to dish, 

DECtape, etc., prior to invoking the 
assembler. 

Output - Same as that produced for $FORTRN; i.e., the object 

module defaults to the system device, and the listing 
defaults to the line printer. 


Examples 


1. $MACROAA.MAC 

The source program, A.D4AC, is assembled. The object 
module, A. OBJ, is output to the system device, by default. 

The listing is produced at the line printer, also by default. 

2 . $MACR0AAAT0ADT1 ; Z , DK ; A 

The source program. A, is assembled, to produce object 
module, Z.OBJ, output to DEC tape unit 1. The listing is 
placed on the RKll disk, as A.LST. 

3 . $MACROAA . MACATO A , LP : 

The result of this form of $MACRO is a listing on the 
line printer. No object module is produced. 
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RNM 


1.2.9 $RNM 


Function - $RNM renames an input file as specified in the 
output dataset. 

Form - $RNMA"old name" ATOA"new name" 

Inputs output -Both are required. They must both be on the 

same physical device. If omitted, the default 
is the system device. 


Examples 


1 . $RNMADT1 : ABC ATOADTl : XYZ 

The file, ABC, is renamed XYZ. 

2 . $RNMAUNOATOADUE 

A file on the system device (UNO) is renamed DUE. 
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1.3 OPERATING PROCEDURES 

1.3.1 Getting Batch On the Air 

Two basic procedures are involved in getting started with Batch. 
The first procedure^ loading the Monitor, is accomplished through 
the console. The second procedure, entering Batch mode, is done via 
the keyboard. 

1.3. 1.1 Loading the Monitor 

Figure 1-5 shows the console of a PDP-11/20. 



Figure 1-5 PDP-11/2J3 Console 

Proceed as follows: 

1. Turn WRITE ENABLE off (for RKll disk only). 

2. Press HALT. 

3. Set the Switch Register to 1731j2fi2fg; (see Figure 1-6). 

4. Depress LOAD ADDRESS. 
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"x" indicates that the switch is in the "up" position (=1) 
Figure 1-5 Console Switch 


5. Set the Switch Register to the address of the word 
count register for the disk on which the Monitor 
resides (for RFll, normally 177462 o for RKll, 
177406 ; for RCll, 17745^g) . See Figure 1-7 a, b, 
and c, “respectively. 

6. Turn ENABLE/HALT switch to ENABLE. 


7. Press START. 
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Figure l-7a Set for RFll Disk 
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Figure l-7b Set for RKll Disk 
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Figure l-7c Set for RCll Disk 


X = this switch is in the "UP" position (equals 1) . 


Figure 1- 7 Switch Settings for Word Count Register 
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When the Monitor has been loaded into core, it responds by print- 
ing : 

MONITOR Vxxxx 

$ 

at the teleprinter. Vxxxx identifies the version number of the Moni- 
tor currently in core, e.g., V^0'6A. Having identified itself, the 
Monitor issues a line feed, carriage return, and prints $ to indicate 
its readiness to accept an operator command. 

Enter the date and time at the keyboard, using the DATE and TIME 

comm.ands . For example: 

DA: 24-MAR-72 
TI: (3r9:15 

Invoke PIP, and enter a UIC of [1,2], as: 

^RUN PIP 

(PIP responds) 

# [1,2]/EN 

fiC 

.KI 


1.3. 1.2 Entering Batch Mode 

When the Monitor responds by printing $ , the appropriate re- 
sponse to invoke Batch mode is to type, immediately after the $, and 
on the same line: 

BA datasetl/switch (es ) ,dataset2 

where : 

datasetl is the batch stream dataset 

dataset2 is the default log dataset^ 

The switches that may be specified are the "time-limit" switch 
and the "no-echo" switch. The time-limit switch governs the maximum 
duration of a job. It is specified as 

/TI:hh:mm 

hh and mm are specified as decimal digits. If both are included, 
hh equals hours, and ram equals minutes. If only one value is given, 
it is assumed to be minutes. 

The no-echo switch suppresses printing of commands at the key- 
board. It is specified as /NE. If this switch is included, only the 
$JOB command is echoed at the keyboard, and the start and finish 
times of the job. 

^ Output related to syntax errors etc., is printed on the teleprinter, 
if the log dataset is omitted. 
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A NO FILE message at the keyboard indicates that the batch 
stream could not be found. The system searches first the current 
user’s area; if it fails to find the batch stream there, it searches 
the system area. If the batch stream is not found there, the NO FILE 
message results. 

The time-limit switch given with this BATCH command takes pre- 
cedence over any specified in a $JOB command. 


Sample BATCH Command 

BA CR:/TI :20,LP: 

The dataset specifiers in the example designate the batch stream 
device to be the card reader, with the log produced on the line 
printer. The default time limit is set to 20 minutes. 

1.3.2 Operator-System Communication 


Batch provides several ways for the operator and the system to 
communicate with each other: the Monitor may print information re- 
garding the status of a job (e.g., error messages); a user program 
may request operator action; or, the operator may wish to exercise 
control of system operation, or respond to a system request. 

1.3. 2.1 Error Messages 

The actions taken as the result of an error in Batch mode are 
described below. (The messages produced are summarized in Appendix F 
of the DOS Monitor Programmer’s Handbook. Certain Fatal error 
messages pertinent to Batch are listed below in Table 1-4.) 

The difference between Batch error processing and DOS error processing 
is mainly in the way these messages are presented to the user, since 
different classes of errors are handled according to their type. 

Action messages (Annn) are printed on the teleprinter, but 
do not appear in the log returned to the user. The system suspends 
operation until the operator responds at the keyboard. Other 
classes of message (I, S, W, and F) are printed at the teleprinter, 
and in the log (unless the user has suppressed the log) . 
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TABLE 1-4 


BATCH MESSAGES 


Error 

Code 


Additional 

Information 


Meaning 


AQQl 


User Ca] 
Address 


Disk address error. Type KILL to abort job, 
then CTRL/C to start next job. 


A,0J?2 


Device in 
Radix- 5^ form.at] 


Device not ready . Make device ready and 
type CO. See Appendix E for device name. 


Aj0j3 3 


AjdjdA 


Link Block 
Address 


The Link Block contains either an illegal 
device code or no device code at all. The 
recommended procedure is to terminate the 
job (KI) . 


User Call 
Address 


DECtape error. Try adjusting the tape; 
type CO to continue. 


AJ0J05 


Pause Number 


A PAUSE was encountered in a FORTRAN program). 
Type CO to continue. I 


AJdIde 


Correct Module 
Name 


Loading paper tape out of order on Pass 2 
of Linker. Load correct module and type 
CO to continue. 


Call Address 


Magtape. The name of the output file be- 
ing created is the same as that of an 
existing file. Type KI to terminate the 
job. 


Magtape. A parity error occurred when try- 
ing to open a file. Type CO to continue 
searching. If the file being sought has a 
parity error, it cannot be found. 


Date or tirrie is invalid. Enter correct 
values via DATE or TIME command and 
type CO. 


AJ3^43 j Disk Pack 

i Block Number 


This is the block that is bad; issued by 
the RKll pack initializer to provide a 
list of bad blocks and to permit job termi- 
nation if too many are bad. Type CO to 
continue, if number of bad blocks thus far 
is tolerable. 


A050 


Indicates that a $WAIT statement was 
processed from the batch stream. 

Type CO to resume program operation, arationj 


Fj2f50 


PC 


Illegal I/O request to the batch stream. 


^(?51 


PC 


Too many consecutive EOF * s or binary errors 
from the batch stream. 
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TABLE 1-4 (cont’d) 


Error 

Code 

Additional 

Information 

Meaning 

Fj3f52 

PC 

Illegal open to one of the batch 
datasets . 

FJ3f53 

PC 

Illegal request to the batch 
stream bypass EMT. 


Note: Radix-50 device codes are summarized in Appendix E. 


If an S (System Program) error occurs, subsequent input from 
the batch stream is ignored, until another command string is detected, 
or a Monitor command is read. 

A Fatal (F) error causes the job to be aborted. If the 
user has specified ’* dump -on -error , " he is given an octal listing 
of the contents of the area he specified to be dumped. 

1.3. 2. 2 Messages to the Operator 

Messages can be sent to the operator from the batch stream, by 
means of the $ME command, which is formatted: 

$ME {^}text 

The $ME command adheres to the syntax conventions used by the 
other Batch commands; i.e., the $ must be in column 1. The command 
itself is separated from the message by either a comma or a space, 
as indicated by {^}. (The braces are not part of the command syntax, 
but merely indicate that one of the enclosed characters must be used 
in this position.) 

The program will continue execution, following the issuance 
of $ME text, unless the user issues a $WAIT command; in this case, 
the operator is required to type in CO to effect resumption of the 
program. 


1-32 












EXAMPLE 


Entries supplied by User, in batch stream (assume job name to be MATX) 


$ME MOUNT TAPE XYZ ON UNIT 1 
$ME DO NOT WRITE ENABLE 
$WAIT 


Response Printed at Keyboard (as seen by the operator) : 


MATX 

MATX 

A050 

$ 


: MOUNT TAPE XYZ ON UNIT 1 
;D0 NOT WRITE ENABLED 

000000 Caction message indicating that 
$WAIT statement is in effect) 


The operator types CO on the $ line to resume the program, 
after the action has been taken. 


1. 3.2.3 Operator Commands 

The operator notifies the Monitor of his intention to type in 
a command by pressing the CRTL and C keys simultaneously, (This action 
is indicated as CTRL/C.) The Monitor responds by printing a period at 
the start of the next line. The operator then types in the appropriate 
command. 

To abort the current job, the opera tor/Monitor message sequence 

is : 


CTRL/C 

_^KI\ (the period (.) is printed at the keyboard in 

response to CTRL/C)^ stands for "carriage return" 

To terminate the batch stream, the operator types 
CTRL/C 

j^TEj 

following which, the system leaves batch mode, returning the Monitor 
to keyboard mode. 
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1.3. 2. 4 Commands Printed at the Keyboard 

The Batch system prints some commands at the keyboard, to help the 
operator monitor a job*s progress. For example, 

$RUN FORTRN 

is printed at the keyboard when this card is read. (It is also output 
to the job log.) $JOB, $GET, $CHANGE and $FINISH are also printed. 

(If the /NE switch is used, only $JOB is printed.) 

1.3.3 MACRO-ll Assembly Procedure 

The MACRO-11 Assembler makes two passes over the source file. 

To assemble a MACRO-11 program, the user must first transcribe the 
program to a mass storage device, by means of the PIP system program. 
This is done as shown in the example in Figure 1-8. 



Figure 1-8 Sample MACRO-11 Job Deck 


Note that the dataset specified as the output dataset (e.g. , 
PROG. MAC) in the PIP command string must be specified as the input 
dataset in the MACRO-II command string. /GO may be used in place of 
/E; the $RUN card would not be needed then. 

1.4 BATCH CHARACTER SET 

Batch uses the 64-character graphic subset of ASCII shown in 
Table 1-5. This table also indicates the correspondence between 
ASCII characters and DECj2f29/jZf2 6 Hollerith codes, as they appear on 
punched cards. 
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Table I -5 


PDP-11 CARD CODES 


CHARACTER 

'ascii 

DECa29 

DEC026 


CHARACTER 

ASCII 

DEC0Z9. 

DEC02&' 

SPACE 

24j2f 

NONE 

NONE 


@ 

300 

8 4 

8 4 1 

1 

041 

12 8 7 

12 8 7 


A 

101 

12 1 

12 1 j 

II 

042 

8 7 

0 8 5 


B 

102 

12 2 

12 2 1 

# 

243 

8 3 

0 8 6 


C 

303 

12 3 

12 3 

$ 

044 

11 8 3 

11 8 3 


D 

104 

12 4 

12 4 

% 

245 

0 8 4 

0 8 7 


E 

305 

12 5 

12 5 

& 

246 

12 

11 8 7 


F 

306 

12 6 

12 6 

1 

047 

8 5 

8 6 


G 

107 

12 7 

12 7 

( 

050 

12 8 5 

0 8 4 


H 

110 

12 8 

12 8 

) 

251 

11 8 5 

12 8 4 


I 

311 

12 9 

12 9 

* 

252 

11 8 4 

11 8 4 


J 

312 

11 1 

11 1 

+ 

053 

12 8 6 

12 


K 

113 

11 2 

11 2 


254 

0 8 3 

0 8 3 


L 

314 

11 3 

11 3 

- 

055 

11 

11 


M 

115 

11 4 

11 4 


056 

12 8 3 

12 8 3 


N 

116 

11 5 

11 5 

/ 

257 

0 1 

0 1 


0 

317 

11 6 

11 6 


1 060 

0 ’ 

0 


P 

120 

11 7 1 

11 7 

1 

i 261 

1 

1 


Q 

321 

11 8 1 

11 8 

2 

i 262 

2 

2 


R 

322 

11 9 

11 9 

3 

063 

3 1 

3 


S 

123 

0 2 

0 2 

4 

264 

4 

4 


T 

324 

0 3 

0 3 

5 

065 

5 

5 


U 

125 

0 4 

0 4 

6 

066 

6 

6 


V 

126 

0 5 

0 5 

7 

267 

7 

7 


W 

327 

0 6 

0 6 

8 

270 

8 

8 


X 

330 

0 7 

0 7 

9 

071 

9 

9 


Y 

131 

0 8 

0 8 

: 

072 1 

8 2 

11 8 2 


Z 

132 

0 9 

0 9 

? 

273 ' 

11 8 6 

0 8 2 


[ 

333 

12 8 2 

11 8 5 

< 

074 I 

12 8 4 

12 8 6 


\ 

' 134 

0 8 2 

8 7 

= 

275 ! 

8 6 ! 

8 3 


] 

335 

11 8 2 

12 8 5 

> 

276 

0 8 6 i 

11 8 6 


t or 

336 

11 8 7 

8 5 

7 

077 ! 

0 8 7 

12 8 2 


or 

137 

0 8 5 

8 2 

{ 

173 1 

; 12 0 

12 0 

j 

} 

\ 

175 

11 0 

11 0 


NOTE 

The code used is ASCII-68. Certain inconsistencies may appear, 
depending on the particular 029 keypunch used. On older keypunches, 
the 1 and t characters' codes are produced by punching the vertical 
bar Cj) and I keys, for codes 12 8 7 and 11 8 7 punches, 
respectively. On newer keypunches, the f character is represented 
as a circumflex • 
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1.5 BATCH FEATURES 


Batch incorporates most of the features of the Disk Operating 
System, providing well-tested, fully-documented facilities to the 
Batch user. 

1.5.1 System Programs 

All programs and utilities included in DOS are available to the 

Batch user . Note that the On-Line Debugging program (ODT) can 
be run through the keyboard only. Table 1-6 lists system programs 
usable in Batch, with the order number of the manuals in which they 
are documented. Chapter 4 describes the modifications made to these 
programs, to allow them to run in Batch. 

TABLE 1-6 

Batch System Programs 


Program Name 
FORTRAN IV 
Edit-11 

PIP,* File Utility Package 

Link-11 Linker and Libr-11 
Librarian 

MACRO-11 Assembler and CREF 
Cross Reference Prograr. 

1.5.2 Programmed Requests 


Manual No. 
DEC-ll-KFDA-D 
DEC-ll-ASDB-D 
DEC-ll-PIDA-D 

DEC-ll-ZLDA-D 

DEC-ll-OMACA-A-D 


The Disk Operating System Monitor Programmer's Handbook ( DEC- 11- 
MWDC-D) includes detailed descriptions of programmed requests, 
which are the means by which a user program calls for Monitor ser- 
vices. Some differences exist in the way certain programmed re- 
quests are processed in Batch mode, to allow for differences in 
the Batch and keyboard environments . 
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CHAPTER 2 


BATCH COMMAND LANGUAGE 


BATCH COMMAND SET 


The information in this chapter is intended for users who 
require a more comprehensive understanding of the Batch operating 
system. It is assumed that the reader is familiar with the PDP-11 
Disk Operating System, DOS, (as described in the publication. Disk 
Operating System Monitor Programmer’s Handbook) . The purpose of this 
chapter is to familiarize the user with the use of the command language, 
as it is applied in Batch operation. Commands which are invoked when 
the system is not in Batch mode, perform exactly as described in the 
DOS manual. The effect of a command in Batch mode depends on whether 
the command is received from the keyboard (following CTRL/C) , or from 
the batch stream. Table 2-1 lists all commands, and their status in 
Batch mode. 


2-1 



TABLE 2-1 


BATCH COMMANDS 


Coinmand 

Action I 


From Keyboard 

From Batch Stream 

$ASSIGN 

Assign a physical device 
and file nam.e, to a dataset 

Same as from Keyboard. 

See Note 1. 

$BATCH 

Invokes Batch monitor. 

Invalid. 

$BEGIN 

Invalid . 

Honored only when program 
loaded, and never started. 

$CHANGE 

Invalid. 

Transfers batch stream to 
dataset specified. 

$CONTINUE 

Resumes program execution. 

Ignored. 

$DATE 

Used as in DOS. 

Can*t contain a value. Causes 
date to be printed in the log. 

$DUMP 

Dumps core to line printer. 
Processing suspended until 
dump complete. 

Same as from Keyboard. 

$ECHO 

As in DOS . 

Invalid. 

$END 

As in DOS . 

Invalid. 

$EOD 

Invalid. 

Delimits physically contiguous, 
logically distinct data. 

$FINISH 

Invalid 

Logical job delimiter. 

$GET 

Invalid. 

Loads a program from the 
specified device. 

$KILL 

Terminates the current job. 

Terminates the current program. 
See Note 2. 

$MESSAGE 

Invalid . 

Outputs a message to the 
operator. 

$MODIFY 

As in DOS. 

No display of location's 
previous contents . 

$ODT 

Invalid. 

Invalid. 

$OWN 

Invalid . 

Allows unformatted reads 
from batch stream. 
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TABLE 2-1 


(cont ’ d) 


i Command 

j 

Action j 


From Keyboard 

From Batch Stream 1 

1 

|$PRINT 1 

As in DOS . 

Invalid. | 

1 

$RESTART 

Invalid . 

Limited usefulness. ! 

! 

$RUN 

Invalid . 

i 

Loads and starts a program. | 

$SAVE 

Invalid . 

Writes the program in core, 
onto the disk in loader 
format 

; $STOP 

Invalid. 

Invalid . 

$ TERMINATE 

Terminates the batch session. 

Invalid. 

. $TIME 

Enter a value for TIME or 
display the time. 

Request that TIME’S value be i 
output to the log. Entering | 
time is illegal. 

$WAIT 

i 

As in DOS. 

i 

Suspends job execution until ; 
CO is typed at keyboard. 


Notes 

1. $ASSIGN should not be used to assign 
devices to BATCH connmand datasets. 
Refer to Chapter 4 for details. 

2. Other commands that force a "KILL", if 
read when the program is reading 
command string input, are; $RUN, $GET, 
$FINISH, $CHANGE, and $JOB. 


2.1.1 Synchronous/Asynchronous Commands 

Certain commands are treated as asynchronous commands, while the 
rest are dealt with synchronously. Asynchronous commands cause actio: 
to be taken as soon as they are read, regardless of whether they are 
read from the Batch command input dataset (logical name CMI) ; from th 
system program command input dataset (PCI)^; or, from a user's datase 

^Command datasets are discussed in Chapter 4. 
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Asynchronous commands include: 


$BEGIN 

$DATE 

$DUMP 

$EOD 

$KILL 

$MESSAGE 

$MODIFY 

$OWN 

$RESTART 

$SAVE 

$TIME 

$WAIT 


Synchronous commands are those which are not executed immediately, 
unless they are read while the program is reading CMI. If read from 
PCI, or a user's dataset, they cause an "end-of-f ile" to be returned 
to the program; the command is held until a READ CMI is issued, at 
which point the command is executed. Synchronous commands include: 


$ ASSIGN 

$CHANGE 

$FINISH 

$GET 

$JOB 

$RUN 


All synchronous commands, except $ASSIGN, force a $KILL, $JOB 
also forces a $FINISH. 


2.1.2 New Batch Commands 


Five commands have been created for the use of Batch. They are: 

1 . $ CHANGE 

2 . $EOD 

3 . $ JOB 

4. $ME 

5. $OWN 


These commands are only legal from the batch stream. They are 
fully described in later sections. 
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2.1.3 BATCH Command 


The BATCH command invokes batch mode. it is described in 
Chapter 1. 

2.1.4 TERMINATE Command 

The TERMINATE (TE) command is entered Lhrough the keyboard, to 
end the batch session. It is legal only from the keyboard, following 
CTRL/C. If entered via the batch stream, the message INV CMD! is 
printed, and the current job is aborted. 

2 . 2 JOB STATEMENT 


Each job to be executed is headed by a job statement, in the 
following form.at: 


$JO[B] 



name [uic] /swl/sw2 I log 


dataset] 


The dollar sign must be in position 1 (or card colum.n 1, if a 
card reader is the input device) . The first tV7o letters of JOB are 
all that is required to identify this as the JOB statement, but it 
can be spelled out completely, for the sake of clarity. The $JOB 
field is delimited from following fields by a space or a comma. 


2.2.1 Job Name 


The job name is specified as a string of alphanumeric characters. 
Characters after the first six are ignored. A space, a slash, or a 
left bracket m.ay term.inate the job name. 

Examples : 


AnameA {whereA=space) 

name/ 

name [ 

The job name is used by Batch for message processing and 
temporary file creation. If the user does not specify a job name, 
one is assigned by the system. 
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Default job names are assigned as sequential numbers, starting 
with 000001. Each time the BATCH command is typed in, the sequence 
is reset* The name 000001 is assigned to the first nameless job, 
000002 to the next nameless job, etc. Any number of user-named jobs 
can intervene between 000001 and 000002. 

2.2.2 User Identification Code (UIC ) 

The user identification code is entered in the format shown 
below : 

[nnn , nnn] 

where "nnn" represents a string of one or more octal digits, up to 
a value of 376. Note: A single zero -cannot he used in place of 
"nnn." J?,nnn; nnn,J3^; and 0,0 are all invalid. The values 0-10 and 
377 are reserved for the system. 

The value to the left of the comma represents the user-group 
number, while the value to the right represents the user*s number 
within the group. 

Example 

[2^2,151] 

This uic specifies user group 2j2f2, user number 151 within that group. 
If the user identification code is omitted, the default uic is used. 
The value of the default uic is installation specified; and observes 
the rule concerning the use of zero. If a uic is not specified in a 
$JOB statement, and the default uic is J? , the job will not be 
executed. 


2.2.3 Sv/itches 


Two switches may be used to specify actions. The first limits 
the length of time that the job can run, measured in clock-on- the- 
wall time, rather than in CPU time. The second switch allows the user 
to suppress the log. Each switch is preceded by a slash, followed by 
the keyword that identifies the switch. 
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The time-limit switch has the format: 


/TI :hh:imn 

where hh and mm are the values specifying hours and minutes, as 
decimal integers. A single value following /TI (e.g., /TI:15) in- 
dicates the number of minutes the job is to run. Thus, to indicate 
hours, but not minutes, the user must enter /TI:hh:0j?, with a value 
for hh. The /TI switch in the BATCH coimnand takes precedence over 
the time-limit specified in the $JOB command. 

The "no-log" sw^itch is specified sim^ply as a slash, followed 
by the letters NL; i.e., /NL . In specifying this switch, the user 
indicates that he wishes no log to be produced for his job. The 
effect of /NL is to suppress the log dataset. 


2.2.4 Log Dataset 

An optional entry can be included specifying the dataset to be 
used for the log, for this job. The dataset specified overrides that 
given in the BATCH command. 

2.3 COMMAND STATEMENTS 


Command statements request that a specified action be performed. 
They may be directed to the Batch Monitor, to the Command String 
Interpreter, or to one of the system programs. 

2.3.1 Monitor Command Statements 

All Monitor commands are prefixed by a dollar sign in position 1 
The following pages describe the commands directed to the Batch 
Monitor, not including concise commands (described in 1.2). Commands 
are arranged in alphabetic order. Only those commands that are valid 
or effective from the batch stream are discussed (refer to Table 2-1) 
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ASSIGN 


2. 3. 1.1 $ASSIGN 
Format 

$AS[S1GN] dataset specifier, logical name 
Purpose 

This command assigns a physical device (and a file name, 
when the device is file-structured) to the dataset identified 
by logical name". The format of "dataset specifier" is: 

dev: filename. extfuic] 

where "dev" designates the device, and filename. extfuic] designates 
the name, extension, and uic, if any, to be assigned to the file. 


The "logical name" is the name that has been specified in the 
link block in the user’s program. 


NOTE: The $ASSIGN command should not be used with 

Batch command datasets (i.e., CMO, CMI, PCI, 
and GDI. These datasets are used for input to 
the Command String Interpreter (CMI ) , related 
output (CMO) , input to system programs (PCI) , 
and data input resulting from a program command 
(GDI) . Refer to Chapter 4 for details) . 


The duration of an $ASSIGN depends on when it was issued. If 
issued at the job level, i.e., after $JOB, but prior to $RUN or 
$EXECUTE , an $ASSIGN remains in effect for the duration of the job, 
unless subsequently altered. If issued at the program level, an 
$ASSIGN is in effect for the duration of that program, unless 
changed during execution of the program. 


Examples: 


To assign a DECtape file named COM. BN to the dataset with the 
logical name ITR: 


$AS DT: COM. BN, ITR 


To assign a disk file to FORTRAN unit number 5: 
$AS FILE. EXT, 5 
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BEGIN 


2. 3. 1.2 $BEGIN 
Format 

$3E[GIN] [, address] 

Purpose 

The $BEGIN command starts execution of an already loaded 
program at the stated address. The address value, if specified, 
is an absolute octal value; if not stated, the normal start ad- 
dress is used. 

The $BEGIN command is used only for programs that have been 
loaded (via $GET) , but have not yet been started. The $BEGIN 
need not immediately follow the $GET. The effect of the $GET. . . 
$BEGIN sequence is the same as the $RUN command; the main pur- 
pose is to allow the user to insert changes into the program, 
which has been loaded, but not begun. The $MODIFY command is used 
make these changes (see 2.3.1.11). 

Example 

$ BEG IN 


Start executing a program at the normal start address. 
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CHANGE 


2. 3. 1.3 $CHANGE 
Format 

$CH[ANGE] dataset 
Purpose 

Changes the batch stream input to the dataset specified. 
This permits data, source programs, etc., to be stored on data- 
sets other than the one used normally for batch input, and then 
to be read in during execution of a job. 


$CHANGE command is a synchronous command. When the $CHANGE 
command is honored, the batch stream is read from the secondary 
dataset. When end-of-file is sensed on the secondary dataset, command 
input is resumed from the primary dataset, at the point following the 
$CH command. 

Example 



DATASET A 

DATASET B 


(Primary) 

(Secondary) 

1. 

$JOB AAA[2J?)J,2J2f;?] 

$RUN FORTRN 

2. 

$RUN MACRO 

#P ROGA , LP ; < P ROGA 

3. 

#FILEA<FILEA 


4. 

$CHANGE DATASETB 


5. 

$RUN LINK 

(EOF) 

6. 

#FILEA,LP : <FILEA, PROGA, FTNLIB/L/E 


7. 

$FINISH 



In this example, when EOF is encountered on dataset B, com- 
mand input is resumed at command 5 of dataset A ($RUN LINK) . 


NOTE 

$ JOB , and $CHANGE are not legal 
in the secondary dataset. The 
job will be aborted if either is 
encountered . 
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DATE 


2. 3. 1.4 $DATE 
Forinat 

$DA[TE] 

Purpose 

Requests that the current date be included in the job log. 

The date will be printed in the dd-immm-yy format- When en- 
tered via the batch stream, the $DATE command may be used 
solely to place the date of the job's execution in the log. 

When the $JOB card is processed, the date and time are put in 
the log. 

The user can enter a date value through the keyboard, while 
Batch is running. To do this, type 

CTRL/C 

j_DATE dd-mm-yy ) 

putting the correct date value in place of 
dd-mmm-yy . 


2-11 



DUMP 


2. 3. 1.5 $DUMP 
Format 


$DU[MP] ,lp: 


, /start addrl 

f, end addrl 


L J 

LI? J 

^ ll 


Purpose 

The $DUMP command causes an absolute copy of a specified 
core area to be written out of core to the line printer. If no 
arguments, other than devicename, are supplied, values are as^ 
sumed by default; i.e., "O", dump from core to the line printer; 
starting at address If no end address is specified, the 

highest word in memory is the default value. A $DUMP command is 
valid at any time; if issued during program execution, operations 
are suspended for the time needed to complete the dump. $DUMP 
can be entered through the keyboard while in Batch mode. 
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2. 3. 1.6 $EOD 


EOD 


Format 

$EC [D] 

Purpose 

Tile 9 EOD coiTQTiancL 5 Lanci.5 ior '‘Enci—ot— Data” • It is tiie coiuiuand 
that delimits groups of data statements that are logically distinct, 
but physically contiguous. 

When this statement is encountered in the batch stream, an 
"end-of-file" is generated and returned to the current program. 

This "end-of-f ile" indicates that the data that follows is logically 
distinct from data the program has read to that point. 

$EOD allows data to be stacked in a deck in physically 
contiguous fashion, while the program treats each group of cards 
as a logical unit, as the "end-of-f ile " is sensed. In the ex- 
am.ple below, the program. PROGA processes data contained in two 
logically distinct datasets: FILEA, and FILEB. The $EOD card 
signals the end of FILEA, by returning "end-of-f ile " to PROGA 
when the last record in FILEA has been read. 


.z 


z: 


{ $FINISIi, 


z 


z 


f $EOD 




Z- 


Z 


RUN PROGA 


$JOB XXY 




FILEB 


j End-of-file 
■< returned at 
1 this point 


FILEA 


NOTE: $EOD provides a logical end-of-file; it is not 

the same as the physical end-of-file card which 
is required to signal the end of a card file. 
(Refer to Appendix B.) 
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FINISH 


2. 3. 1.7 $FINISH 
Format 

$FI [NISH] 

Purpose 

The $FINISH command is used to delimit a job. When a 
$FINISH is detected, it signifies that the current job is ended. 
There are no arguments associated with $FINISH. 

Processing continues with the next $JOB statement. Note 
that the $FINISH command cannot he entered through the keyboard 
while the system is in hatch mode. 

To terminate the batch stream from the keyboard, type: 

CTRL/C 
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2. 3. 1.8 $GET 


GET 


Format 


$GE[T] 


program specifiex 


/DU 



Purpose 

This command causes the program to be loaded into core from 
a specified device. The program specifier entry can include the 
device identifier, and the filename (and extension, if any) and 
uic of the program to be loaded. A $BEGIN command would, at 
some point, normally follow the $GET, to start the program. 
(Refer to 2. 3. 1.2.) $GET can also be used in conjunction with 
the $SAVE command (see 2.3.1.15). 

A "dump-on-error " switch (/DU) is available, allowing the 
user to obtain a dump of a specified area, in case an error 
occurs in his program. One of three values may be specified 
with the dump switch: 


PR[OGRAM] - dump the program area 

AL[L] - dump core in its entirety 

V , - dump the area delimited by the octal 
^ ^ addresses specified for and V^- 

V" must be greater than and must 
be even (i.e., word boundaries). 


The default value is PR. The dataset to which the dump is 
made is system-defined. 
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The "program area" depends on the location of the stack 
pointer . 


1. If the stack pointer is below the load address^ the pro- 
gram area is from the stack pointer to the top of core; 

2. If the stack pointer is not below the load address, the 
program area is from the load address to the top of core 


/DU forces an automatic dump in the event of an error, thus 
providing the Batch user a means of debugging his program. Refer 
to Chapter 3 for the format of error dumps . 
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KILL 


2. 3. 1.9 $KILL 

Format 

$KI[LL] 

Purpose 

The $KILL command terminates the current program, stops 
I/O and closes all open files. Processing continues at the next 
command prefixed by a $ , No arguments are specified for $KILL, 

The $KILL command can be entered via the keyboard to abort 
the job while in batch mode: for example, to abort a job that 
is threatening to pre-empt system resources to the detriment of 
other jobs. Type in the sequence 

CTRL/C 
.KILL J 

The following commands force a KILL: 

$CHANGE 

$FINISH 

$GET 

$JOB 

$RUN 
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MESSAGE 

2.3.1.10 $MESSAGE 


Format 

$ME[SSAGE] 

Purpose 


The $ME statement is used to send a message to the operator. 

A single message consists of one line. To send a message from the 
batch stream, the user inserts commands in the following format; 


$ME 



any text 


The text portion of the lines can be any message the user wishes 
passed to the operator. The message is printed on the teleprinter. 


Example of the $ME Usage : 

Message lines in batch stream (job name TBLT) ; 

$ME MOUNT DECTAPE LABELLED XYZ ON UNIT 1 

$ME DO NOT WRITE ENABLE 

$WAIT 

Keyboard output; 

TBLT : MOUNT DECTAPE LABELLED XYZ ON UNIT 1 
TBLT : DO NOT WRITE ENABLE 
A050 000000 
$ 

The keyboard output includes the job name (TBLT) in the message line. 
The Action message (Aj3^5^2^ 000000) indicates that a $WAIT is in effect; 
the program is suspended until the operator types CO on the same line 
as the $ . 


The $WAIT statement is optional; if omitted, the message is 
printed at the keyboard, but the program continues without suspension 

(Of course, the A050 mm, $ lines are not printed, since no opera- 
tor response is expected.) 
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MODIFY 


2.3.1.11 $MODIFY 
Format 

$M0 [DIFY] Ooct al addr:new contents 
Purpose 

This command provides a way of changing the contents of a 
memory location. Whatever was in the location is altered to the 
value specified in the "new contents" field. The system m^kes 
no provision for displaying the previous contents of the address. 
The value specified in the "octal addr" field must be an even 
number (i.e., aligned on a word boundary), and must not exceed 
16 bits. Locations in the resident Monitor may not be MODIFied. 

Example 


$M0 2164j2f:16j2f40 


This changes the contents of location 21640 to 16040. 


NOTE 

The location specified must not fall within 
the area occupied by the Monitor or the job 
will be aborted. 
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OWN 


2,3.1.12 $QWN 
Format 

$OW[N] 

Purpose 

This command causes the system to enter a mode of operation 
called "own mode"^ which allows data to be read in unformatted 
mode. Statements in the batch stream are treated as pure data; 
thus^ special characters^ such as $, #, and *, which might or- 
dinarily cause some Monitor action to occur, are treated as date 
rather than control characters. 


Currently, the $OWN command can be used only when the 
batch stream device is the card reader. 


Return from own mode to normal input mode is effected by 
placing an end-of-file card at the end of the data. 


NOTE 

The characters $, #, and * can also be read 
as data, rather than control characters, by 
placing an apostrophe in the first position 
of the line (refer to section 2.4). 
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RESTART 


2.3.1.13 $ RES TART 

Format 

$RE [START] [, address] 

Purpose 

This command permits a program to be restarted. As shown, 
the user may optionally supply an address at which the program 
is to be restarted. Normally, a restart address will have been 
specified by the program. It is recommended that the address 
option for $RESTART be used with care. 

$RESTART is valid only when the program is already loaded. 
Before the program is restarted, the stack is cleared, any cur- 
rent I/O is stopped, and all internal busy states are removed. 
Buffers and device drivers set up for I/O operations will, how- 
ever, remain linked to the program for future use. 

The $RESTART command is invalid if a restart address has 
not been specified, either by the program, or by an address 
field with the command itself. $RESTART may not be entered from 
the keyboard while the system is in batch mode. 
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RUN 


2.3.1.14 $RUN 


Format 

$RU [N] , program specifier 


f :PR[OGRAM] Y 
/DU / ;AL[L] \ 


L I' 




jJ 


Purpose 

The $RUN command causes a named program to be loaded from 
a specified device, and started at the normal address. 


The program specifier provides the name of the program, and 
the device from which it is to be loaded, and, optionally, a user 
identification code that is associated with the program. 


As with the $GET command, a "dump-on-error" switch may be in- 
cluded, in the format 


/DU 


:PR[OGRAM] 
;AL[L] 
:Vi:V2 


where : 


PR[OGRAM] 


means "dump the program area" (see the 
description for $GET, section 2. 3. 1.8); 


AL[L] 


means "dump all of core"; and 


V, :V^ means "dump the area bounded by the 

^ octal addresses specified for and 

^2* ^1 ^2 even values 

(i.e., word boundaries), and must 
be greater then V^. 


The default area is PROGRAM. If no /DU switch is included, 
no dump-on-error occurs. The dataset to which the dump is made 
is system-defined. 

Example 

$RU DT: PGM/DU 

The program named PGM is loaded from DECtape, and started- The 
dump on error specification requests that the program area be dumped 
(by default) . 
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SAVE 


2.3.1.15 SSAVE 


Format 


$SA [VEjj^dataset specifier j/RA: low :high*J 
Purpose 


L 


The $SAVE command allows a program to be saved in loader 
format. It is used after a program has been loaded into core, 
prior to starting the program. The program is copied onto the 
device specified in the dataset specifier, under the name that 
is included in dataset specifier, if any. 


The $SAVE command may be used only if the program was never 
started. A common use of $SAVE is to $GET a program (load it) , 
insert fixes through $MODIFy commands, and then place the altered 
program onto secondary storage through a $SAVE command. 


If no dataset specifier is included, the current program 
will be saved on the system disk, under the name SAVE.LDA. Any 
file previously saved under this name will first be deleted. 

The /RA switch is included so the user can save an area 
other than that comprised by his current program. If he wishes 
to save only the current program area, this switch is omitted. 
Including the /RA switch allows the specified area to be saved. 
The addresses specified for /RA must be valid octal word bound- 
ary addresses . 

The command will be rejected if an additional 256 word 
buffer cann.ot be allocated from free core. 

Example 

$SA,REG,LDA 

The $SAVE command in this example causes the current program to 
be saved on the system disk, under the name REG.LDA. 


2-23 



TIME 

2.3.1.16 $TIME 
Format 

$TI[ME] 

Purpose 

Including the $TIME command provides a means of obtaining 
the time-of-day in the output job log. It does not 
permit the user to specify a time from the batch stream. At- 
tempting to do so is illegal. (The current job will be aborted.) 

To enter a time value, the user should type, at the keyx^oard, 
CTRL/C 

^TIME hh.mm.ss^ 

This is a valid entry from the keyboard, while the system is 
operating in batch mode. 

The time-of-day is also placed in the job log by the $FINISH 
and $JOB commands. The $JOB command also includes the current 
date. 
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WAIT 

2.3.1.17 $WAIT 

Format 

$WA[ITJ 

Purpose 

This command suspends processing, and causes the Action 
message 

A050 000000 

$ 

to be printed at the keyboard. It is usually used in conjunction 
with the $ME command. To resume operation, type CO. 
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2.3.2 Input to Command String Interpreter 


The Command String Interpreter (CSI) accepts as input, command 
strings consisting of dataset specifications. The purpose of a command 
string is to establish the datasets to be used by a particular program, 
for input and output. In Figure 1-4, the third card (#MATX, LP : <BI : ) is 
a command string. As indicated there, the first character must be #, 
in column 1 (or in line position 1, if input is not from a card) . 

The format of a CSI command is: 

#output dataset (s) <input dataset (s) 
where a dataset can be specified as 

dev: filename. ext fic] /sw^:v^. . •Vn/sw^:v^. . .v^ 

Each dataset specification is delimited by a comma. The elements 
ccm.prising a dataset specification provide information concerning the 
dataset's location, its file name and extension (if it's a file), 
the user identification code associated with the file, and any switches 
that may be used to specify particular actions to be performed. 

Device specifiers are selected from those listed in Table 1-2. (Refer 
to Chapter 1.) The ability to include the pseudo-device specifiers 
(BI and SY) is a feature of Batch that provides device-independence 
when specifying datasets to the Command String Interpreter. It allows 
a dataset to be specified without requiring that the user know what 
device may actually be used at job execution time. 

For example, a user may have his source data on cards, but, be- 
cause of the greater speed to be gained by reading the data from a 
faster device, he may transcribe the data onto another storage medium, 
such as disk. He would then specify the disk to be the batch stream 
device . 


$RUN FORTRN - run the FORTRAN IV Compiler; 

#DK:PRG,LP: <BI: - specify that the input dataset 

is located in the batch stream. 

The same command string can be used, whether the batch stream 
is coming from disk, magnetic tape, DECtape, paper tape, or cards. By 
specifying BI, the user has ensured that the command string is valid 
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for all these devices; there is no need to change the card to match 
the specific device. 


The SY device specifier is used to designate the system-residence 
device, as in the following example: 


#SY:FILE.FTN<PR: 


ex an 


- c? -!- ■! r*. 4- TZJ T D 


-Ft iiisc: 


-jc: 


to be input from the paper- tape reader, and output to the system- 
residence device. This command string is valid, whatever the 
system-residence device may be when PIP is executed. 


2.3.3 System Program Commands 

Commands that are directed to system programs (refer to Table 1-6, 
Chapter 1) are identified by an asterisk in position 1. For example, 
to issue the "Insert" command to Edit-11, the user must include a 
command in the format 

followed by the text to be inserted. Refer to the appropriate manual 
for details on the comm^ands used in system programs. 
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2.4 


READING CONTROL CHARACTERS AS DATA 


The characters $, #, and *, appearing in the first position of 
a line (or card column 1) , are interpreted as control characters, 
and are stripped off before the remainder of the line is passed to 
its destination (Monitor, Command String Interpreter, or system pro- 
gram) . It may happen that the user wishes to include one of these 
characters as actual data, to be passed along with the rest of the 
data on the line, rather than having it stripped off. To do this, 
place an apostrophe in the first position; e.g., 

*$AMT 

which causes the line to be passed as $AMT 10j^ (the apostrophe is 
stripped) . 

If the apostrophe is not found in column 1, but the $ is there 
instead, the card would be treated as a command to the Monitor. 

Valid control statements can be included, to cause the Monitor, 
CSI, or system program to take a desired action. Thus, a deck of 
cards being read by a user program may include a statement such as 

$RUN PIP 

to invoke the Peripheral Interchange Program for whatever reason the 
user may have. When the $RUN PIP card is encountered, an EOF is re- 
turned, and the card is held until a READ is issued to the Conunand 
Input dataset (CMI) ; at this point, the $RUN PIP card is passed to the 
Monitor, which causes the user program to be terminated, and PIP to be 
loaded and executed. (Refer to the discussion of synchronous/asyn- 
chronous commands, in Section 2.1.1.) 
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CHAPTER 3 


INPUT/OUTPUT 


3.1 BATCH INPUT 

Input to Batch can be from any PDP-11 device that can perform 
the input function. Data can be read from the batch stream in one 
of two ways: "normal" mode, or "own" mode. 

3.1.1 Normal Input Mode 

In most cases the normal input mode is employed when reading data 
from the batch stream. Data read in normal mode must be formatted 
data. Attempting to read unformatted data, if not in "own" mode, re- 
sults in a fatal error, aborting the job. (See the DOS Monitor 
Programmer ^ s Handbook for a definition of formatted data.) 

This requirement stems from the need to check the first position 
on each line for the presence of a control character. Because it is 
impossible to determine the beginning and end of a line in unformatted 
data, a situation could arise v/here the control card could be inad- 
vertently bypassed, causing unpredictable results. All for- 

matted READS from the hatch stream m^ust have a byte count of at 
least S3 specified in the line buffer header maximum byte count word. 

3.1.2 Own Mode 


It is occasionally necessary to read in unformatted mode from 
the batch stream; e.g., when translating EBCDIC characters to ASCII. 
This is permitted by means of the SOWN control card, which indicates 
to the Monitor that all characters read from that point, until the 
next physical end-of-file (EOF) card (that terminates "own" mode) , 
may be read as unformatted data. The characters $, #, and * are 
not treated, as control characters^ but as data. 

The physical end-of-file (EOF) card statement must be included at 
the end of the user's "own" data, to avoid the possibility of failing 
to recognize a control card. The operator must place an EOF card at 
the end of each job, to prevent the next job from being read as data, 
if the prior user forgot to tezmiinate "own" mode. For added safety, 
the user should place an EOF card immediately ahead of his $JOB card. 
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3.2 


BATCH OUTPUT 


Output from Batch includes program listings, output associated 
with system programs (such as load maps), the job log, and dumps, 

3.2.1 Job Log 


The job log is the record of events that occurred during execu- 
tion of the job: the control cards processed, commands read, and 
error messages generated. The first line of the job log contains the 
image of the $JOB command, as specified by the user, the date, and 
the time. This is followed by a sequence of images of control cards 
that were read in and processed up to the point at which the $FINISH 
command was read, or a fatal error occurred. Any error, warning, or 
informative messages are included in the log as they are encountered. 

A log is produced for all jobs, unless the log-suppress switch 
(/NL) was specified in the $JOB card, provided that a log dataset was 
included in the BATCH command , or in the $JOB command. 

3.2.2 Dumps 

If the user has specified the /DU sv/itch on the $RUN or $GET card 
for the program, and an error occurs, a dump of the area specified in 
the /DU switch is produced. The first page of a dump, the Header 
page, consists of a summary of information regarding the dump itself. 
It is formatted as shown in Figure 3-1. 


****** Dujyip OF HEADER FOLLOWS ****** 

STARTING WORD OF DUMP = nnnnnn 

NO . OF BYTES DUMPED = nnnnnn 

R^3^ = nnnnnn 

R1 = nnnnnn 

R2 = nnnnnn 

R3 = nnnnnn 

R4 = nnnnnn 

R5 = nnnnnn 

SP = nnnnnn 

PC = nnnnnn 

PS = nnnnnn 

HIGH ADDRESS = nnnnnn 

LOW ADDRESS = nnnnnn 

DUMP IDENTIFIER MESSAGE 

Figure 3-1 Sample Header Page 
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The values of '’nnnnnn” are given in octal, and are left- 
justified (e.g,, the value 477, in the NO. OF BYTES DUMPED entry 
would appear as: 

NO. OF BYTES DUMPED = 477) . 


The subsequent pages of the dump comprise the area specified in 
the /DU switch. As shown in Figure 3-2, each group of four lines 

describes locations, and is headed by the flag n , where 

n corresponds to the first location in the group; 10 ^, 20j?, etc. 


Each line in the dump contains the contents of eight words, re- 
presented as octal values. If a sequence of lines contain all zeroes, 
the first line in the sequence is printed in its entirety. 


The next line is printed with asterisks in the first position, e.g. : 
401 ****** 

Subsequent lines in the sequence are omitted altogether. The next 
non- zero line is printed. 


At the end of each line is a field of 16 ASCII characters, which 
is the ASCII contents of each byte. ASCII equivalents of characters 
that are not within the printable range are mapped into the printable 
range, converted to upper case Cif necessary ) , and printed. 

Figure 3-2 illustrates the form and content of a dump. 
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****** CF DAT* foU.DI'.S ****** 


*^*1 5F7^P**“* 

FfiPt 7.77777 777797 779977 999277 979999 9999,99 9999971 


• »»1570 

999 i 7eS2F6 799977 P0?7F4 \A9992 9299.79 979.977 PF11?3« V je»TAC**« F •f' ACR 
272t 0001 1 7 299999 99977<^ 0^0557 071370 05610P 001504 0501 1 4 | C«»*<!*»<0VPEl. DCLP 
e4e j 03^072 026107 006507 0000 12 047506 0521 22 047122 000000 1 Z0C1 Gf'J.*F0fiTRK #• 
060» 000076 023752 077736 026105 001504 0501 14 036072 001510S a# JT-aCFI CrLPZCHC 


» — 157100 — 

000S 044EP2 006472 000012 050103 000131 979797 797977 000004? RTZK J»CP Y*»*#»TP 
020J 062570 000000 036103 006507 000012 042504 000i»4 000001s XF(I«C6G^ J«CFL*A« 
040 s 000000 000026 062570 000000 027503 042504 043454 005015 ? •»Y0XF(»«C0CFLGMJ 
060? 044504 000122 000000 000000 000040 062570 000000 001504? DTP^ff^Si'XPf^OC 


*••1 57200*‘»"« 

000? 041 1 1 3 036072 00 1504 054523 027470 044''04 043454 00501 5 : KPZf Cf S YZr C T L D 6 J 
020? 054105 000000 000000 001430 000000 001430 177777 000000? EX4#i«Xr#*XrCC(l4 
0401 001430 177777 157306 000000 005403 005266 157316 157316? XrCPFA«*0KV.1MAKA 
060? 015572 001402 104001 177776 001066 000011 000000 000004? Z ffir 4 HaCVBI»*4C* 


»— 1 57300--- 

000 1 1 67342 15677^ 001 000 01567*: 007150 0i5'!74 000001 007150 * BaaI 40* fMKC fA'NK 

020 ? 000400 000000 000000 00000 0 00 00 0 1 000001 157422 0 00004? •4(l(»|l»ii«A*A4RCD4 

040 ? 000000 177777 1 56776 005000 005001 005002 00':003 005004 ? •*CC a] •,1A,1R JCJD J 

060 ? 012705 00000 1 006046 005046 005046 1 04064 01 0504 0 1 3700 ? El A AF JF JF .IT 5DC • X 


— — — 15740 0- — — 

000? 000040 016046 000004 162716 001000 012746 107777 005046? #«F<;c*KF«nFLCCF J 

020 1 1 04064 010503 012746 000400 012746 pni050(? 0050A6 104064 ? T5CGFl*AFl AAFJTI- 

040? 010502 010546 010546 005046 104064 010501 010015 000000? RrFCPPF.TTPAGWP*# 

060? 000000 000000 000102 000003 000000 000000 157700 000000* 4 • A • P 00 • * • 4 • A # 


-—-1 57500——— 

000? 010706 024646 010705 062705 000112 005001 013716 177'70* FTP TE'^FFJaA JKXXC 
020 ? 00601 6 103402 005016 000403 006316 001001 0101 16 005000 ? M RGN Jr, A KL A PK P A J 
040? 004715 106303 001374 004715 004767 000074 050402 162702* ^TC JCP0I5 TCABCBE 
060 ? 000004 022702 000002 001441 004767 000054 061604 0 1 0401 ? 0 APFP A ATI* T L ACf AS 


--- 1 67600--- 

000! 004715 002004 125700 021753 000000 000751 110321 000770? MTCrAXKfAAlAGPXA 
020! 016703 000152 105213 105713 102376 116323 0P0002 060300* C1 J AK JKH aaCCRAAA 
040 ? 242703 177400 005302 020277 012667 000046 004715 01 0304? CF ACP ,1G A I* I F Ap TDP 
060 ? 00471 5 000303 050304 01 6707 000032 004767 1 777*2 00471 *? P TC A DPP’ X« i* T JCP I 


Figure 3-2 Sample Data Dump 
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CHAPTER 4 


BATCH PROGRAMMING CONVENTIONS 


This chapter is aimed at programmers responsible for writing, 
modifying, or maintaining programs that function in the Batch operating 
system environment. Familiarity with DOS is assumed. 

To function properly in Batch, programs must observe certain 
conventions. Currently existing programs should be modified to con- 
form to these conventions, if the user intends them to operate in 
the Batch environment. 

As an aid in making the modifications, assemble the programs to 
be modified, with MACRO-11, and obtain a CREF listing. The cross- 
reference data will help in locating and examining relevant link 
blocks and file blocks. 

4.1 COMMAND DATASETS 

Command String Interpreter input, and related output must be 
accomplished by datasets with the logical names; CMI (for command 
input) ; and CMO (for command- related output) . 

Command input to system programs, such as the *I command to 
Edit-11, must be through a dataset with the name PCI. Data read as 
the result of processing a command such as *1, must be read from a 
dataset named CDI. That is, the I insert command (*I) is read from 
PCI, while the text to be inserted is read from CDI. 

4.1.1 Command String Input (CMI ) 

The dataset named CMI is used for all Command String Interpreter 
input; i.e., all commands with a # symbol in line position (or card 
column) 1. When reading CMI, a .WAIT should follow the .READ, and 
a test for end-of-data (EOD) should be made; if EOD has occurred, 
the Monitor EXIT EMT should be issued. 
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4.1.2 Command Output (CMQ ) 


The dataset with logical name CMC is used for: 

a. All Command String Interpreter related output (such as 
syntax error announcements, and the # symbol); 

b. all responses to program command input (e.g., *) ; 

c. all error logging. 

A default must be specified for the CMC physical device. This 
default must be 


KB: 


so that the program will run in either DOS or Batch mode. 

NOTE: Because the physical devices for the datasets used 

for command string input and output will, in all 
likelihood, not be the same? it is recommended that 
a .WRITE to CMO be followed by a .WAIT, before is- 
suing a .READ to CMI, and vice-versa. 

4.1.3 Program Command Input 

All program command input must be entered via a dataset named 
PCI. That is, all commands prefixed by * must be read from PCI. 

When end-of-data (EOD) is detected from PCI, the proper procedure is 
to clean up the current Command String Interpreter request (# command) , 

and read the next # command. Input to programs, other than program 
commands, such as an insert to Edit-11, must be entered via a link 
block that has a logical dataset name CDI . When EOD on CDI is de- 
tected, the current *command processing has finished. The next * 
command should be read from PCI, 


4.2 READS FROM BATCH STREAM 


As described in Chapter 3 , all READS from the batch stream must 
be formatted, unless the $OWN command has been issued. All formatted 
READS from the batch stream must have a byte count in the line 
buffer header of > 83^^. This requirement precludes corruption of 
commands that may be read by the user. (If the byte count is less 
than 83^^, a command on a card might be truncated before being read in 
its entirety.) 
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4,3 PSEUDO DEVICE SPECIFIERS 


The device specifiers BI and SY are used when the user wishes to 
call for the Batch Input device, or the SYstem residence device, but he 
does not know which device is actually being used. Since these speci- 
fiers do not call for a "real" device, in the way that CR or DF do, they 
are termed "pseudo" device specifiers. They allow the system to 
supply the actual device that is being used at job execution time, 
in place of BI or SY . Thus, the same control cards can be used, re- 
gardless of the particular device being employed. 


4.4 USE OF $ASSIGN 


The ASSIGN statement must observe the rules listed below: 

1. $ASSIGN must not be used with any Batch system 
program's logical dataset name. I.e., the user 
must not assign a dataset to CMI , CMO, GDI, or PCI. 

2. An $ASSIGN that is made at the job level is 
global to the job, thus; 

$JOB MAC [ 200 , 200 ] 

$ASSIGN DTjaf:CRT,RDO 

causes a file named CRT, which is on DECtape, to 
be assigned to the dataset with logical name 
RDO. This assignment, if not altered by a 
later ASSIGN in the job, remains in effect 
for the duration of the job (MAC) . 

3. An $ASSIGN that is made at the program level 
remains in effect (if not subsequently altered) 
for the duration of the program. 

$GET PROG 

$ASSIGN DK:MTX.OBJ,DCL 

$BEGIN 

The assignment of file MTX.OBJ, on the RKll 
disk, to dataset DCL is in effect for the 
duration of PROG. 


4.5 NOTE PERTAINING TO .CSI2 RETURN CONDITIONS 

The user should note that on return from .CSI2, the top of the 
stack may have bit 2 set. Bit 2 is set when a default device is re- 
turned by the Command String Interpreter; i.e., the user has not 
specified a device in a command string, but has chosen to use the 
default device, instead. 
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As documented in the DOS Monitor Programmer's Handbook, the user 
is only required to check bits j? and 1 . In cases where this is done 
by checking bit 1 (to determine that no error occurred) , and then 
checking the value of the v7ord for a zero or non- zero value, the 
presence of a "1" in bit 2 may lead to erroneous assumptions. 

4.6 ERROR HANDLING 

The Command Output dataset (CMO) must be used for output 
of all error announcements that come directly from a system program, 
rather than via an lOT. Direct error announcements include announce- 
ments of command string syntax errors, and supplementary information 
(such as file names) concerning error announcements made through an 
lOT. 


An EMT has been incorporated into the Batch system, to allow the 
currently running program (system or user) , to request that lines in 
the batch stream be bypassed, until a specified type of control card 
is encountered. For example, if a command string syntax error occurs, 
it may be desired to bypass all following statements up to the next 
$ or # statement. This EMT is incorporated by including the following 

MOV #CODE,-(SP) 

EMT 67 

where CODE'S value determines the next statement type to be read (not 
bypassed) : 

CODE STATEMENT TYPE 

$ 

1 $ or # 

2 $, #, or * 

Any other value for CODE is invalid, and causes a fatal error (F^53) . 

The DOS convention of announcing command syntax errors, by 
printing the command as far as the point of the error, followed by ? 
is still used in Batch, but the EMT shown above must be included to 
cause the batch stream to be bypassed from the point of the error 
until a line starting with $, or # is found. (CODE = 1) EMT 67 is 
a NOP when the system is hot in Batch mode. 
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APPENDIX A 


OPERATING THE CARD READER 


A.l CRll CARD READER 

The usual medium of input to Batch will be the CRll card reader. 
Two models are available for use with Batch: CR-llA, and CRll-B. 
Operating procedures for each are detailed below. 

A. 1.1 CRll-A Card Reader 

Figure A-1 illustrates this model. To operate CRll-A; 

1. Turn power switch ON. 

2. Remove card-deck weight from input hopper. 

3. Place card deck in input hopper. Cards should be 
face down, with the notched corner to your left. 

Edges of all cards should be aligned evenly. 

4. Replace card-deck weight on top of deck. 

5. Press MOTOR START button. 

6. Press READ START button. 

The unit is ready for operation if the green lights associated 
with MOTOR START and READ START are lit; no red lights should be on. 
If a red light is on, do not attempt to enter the BATCH command at 
the keyboard, because the card reader is not ready. 
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Figure A-1 


Model CRll-A Card Reader 
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A . 1 . 2 


CRll-B Card Reader 


Model CRll-B is shov/n in t'Laure A-‘2. it is operated as follows 

1. Turn power on (switch located in upper left corner 
in back of the unit) . 

2. Remove card-deck weight from input hopper. 

3. Place deck in hopper, with cards evenly aligned, 
face down, notched corner to your left. 

4. Replace card-deck v/eight on top of deck. 

5. Press RESET button. 



Figure A-2 Model CR-llB Card Reader 
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APPENDIX B 


MULTIPUNCH CARDS 


B.l BRACKETS [ ] 


Figure B-1 illustrates ^he left bracket (12-8-2) in coluinn 5, 

and the right bracket (ll-8-'2) in column 10. Note: 12=&, 11=’^. 

S b‘ 


0 G 0 0 0 0 0 0 0 0 0 0 0 0 0 9 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Q 0 0 0 0 Q D 0 0 0 0 0 0 0 0 0 11 G 0 0 3 0 0 0 G 0 0 0 0 0 0 

1 a 3 i 5 S M 9 IB II 1313 MIS IS 17 18 19 !1!1 22 33 28 7S 26 27 28 29 30 31 32 33 38 35 36 37 38 39 4081 82 83 8485 46 87 88 89 50 51 52 53 58 55 56 57 58 59 SO 61 62 63 68 65 66 67 68 69 70 71 72 73 78 75 76 77 78 '9 SB 

1 1 1 11 1 n 11 1 11 n 11 11 n n 1 1 n 11 1 1 1 1 m 1 n n 11 1 1 1 1 1 ) 1 1 n 1 1 n 1 1 1 1 1 1 1 1 1 1 1 ! 1 m 11 ! 1 1 n 

22221222212 2 2 2222222222 22222 22 2 22 2 2222 2222 2222 2222 2??? 2??22??2222n2222222222222 
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Figure B-l 029 Bracket Multipunches 
B.1.2 026 Code 

Figure B-2 illustrates the left bracket (11-8--5) in column 5, 
and the right bracket (12--8-5) in column 10. 
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Figure B-2 026 Bracket Multipunches 
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B. 2 


END OF FILE CARD 


The Eiid-Of-*File card is multipunched as 
in column 1. See Figure B-S . 
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Figure B-3 End-of-File Card 


B.3 BLANK SUPPRESS 


The Blank Suppress card has a multipunch of 12-11-J0-7-8-9 
in column 1. See Figure B^4. 
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Figure B-4 Blank Suppress Card 
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B, 4 ^26/029 MODE CARDS 


Figures B-5 and B-6 illustrate tfie 026 and 029 Mode cards. 
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Figure B-5 12f26 Mode Card (12-2-4-8) 
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Figure B— 6 029 Mode Card (12-0 2—4—6 8) 
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APPENDIX C 


OPERATING THE LPll LINE PRINTER 


C.I CONTROL PANEL 

The LPll ConiroJ Panel is located at the tot) of the cabinets to 
the left of the window. This panel contains the controls for normal 
operation of the printer. 

To operate in Batch, the line printers controls and indicator 
lights must be set as follows: 

1. POWER indicator on; 

2. READY indicator on; 

3. ONLINE/OFFLINE switch in UP (ONLINE) position; and, 

4. ONLINE indicator lit. (If the printer is not on-line, the 
system hangs until the ONLINE/OFFLINE switch is put to ONLINE.) 

C. 2 MAINTENANCE PANEL 

The maintenance panel contains controls used for the line printer’s 
initial set-up and maintenance. It is accessible only by opening the 
front cabinet door, located beneath the control panel. 

This panel contains three switches, and three indicators. 

1. Main AC power switch; 

2. PRINT INHIBIT switch - must be off (down) to enable 
printing; 

3. DRUM GATE indicator - if lit, drum gate not properly 
locked; 

4. PAPER FAULT - if lit, check for no paper, or torn paper; 

5. PRINT INHIBIT indicator - if lit, turn 
PRINT INHIBIT switch off. 

6. MASTER CLEAR switch - spring-loaded to off (down) ; 
if toggled to on (up), resets printer logic, turns 
off READY and ONLINE indicators. 

C. 3 ADJUSTMENT CONTROLS 

Controls are provided as listed in Table C-1. 
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Table C-1 Adjustment Controls 


Control 

Location 

Function 

Drum gate latch 

Gearshift type knob near 
right-hand side of main- 
tenance panel . 

Unlocks drum gate 
which can then be 
swung open for access 
to components on back. 

Tractor paper width 
adjustment 

Setscrew at far right of 
tractor pressure plate 
behind drum gate. 

Adjusts right tractor 
for various paper 
widths; left tractor 
is factory adjusted. 

Tractor horizontal 
tension adjustment 

Next to left side of 
tractor paper width 
adjustment. 

Adjusts horizontal 
tension of paper. 

COPIES CONTROL lever 

Extreme upper right-hand 
corner of cabinet just 
above drum gate hinge. 

Adjusts the distance 
between hammer bank 
and character drum 
for different numbers 
of printed copies. 
Settings are; 1-2, 

3-4 and 5-6. 

Paper vertical ad- 
justment control 

Knob at upper left of 
cabinet, directly above 
right-hand side of 
maintenance panel 

Adjusts vertical 
alignment of printing 
so that it prints on 
lined paper. Can be 
adjusted to plus or 
minus one line and 
may be adjusted while 
the printer is in 
operation . 

Top-of-form in- 
dicators 

Red arrows visible when 
drum gate is swung open 
one on each side of 
paper directly below 
tractor pressure plates 

Aligns paper during 
loading . 


C.4 LOADING PAPER 


Follow the steps listed below to load paper into the printer. 

Step Procedure 

1. Open front door of cabinet to gain access to maintenance panel 
and turn main AC power switch on. Verify that control panel 
POWER indicator lights . 

2. Lift control panel TOP OF FORM switch and release to move 
tractors to correct loading position. 

3. Open the drum gate by moving the drum gate latch knob to the 
left and up. Swing drum gate open. 
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SteD 


Procedure 


4. Adjust right-hand tractor paper width adjustment for proper 
paper width. This is accomplished by loosening the set screw 
on the 80-column model or by using the easy release m.echanism 
on the 120-column model. Make certain that the right-hand 
tractor is tightened in place after it is adjusted. 

5. Open spring-loaded pressure plates on both tractors. 

6. Load paper so that a perforation is pointed to by the two red 
arrows c top—ol — loriu indicators; . Paper snouici lie siuootniy 
between tractors without wrinkling or tearing the feed holes. 

7. Close spring-loaded pressure plates on both tractors. 

8. Adjust the COPIES CONTROL lever to the proper number for the 
number of copies to be made. For example, set to 1-2 for 
single forms, set to 5-6 for six-part forms. 

9. Close drum gate and lock into position with drum gate latch. 
After approxim.ately 10 seconds the control panel RJEADY ind-icator 
should light. If it does not, check to see if any error is 
indicated. An error is indicated if one of the following 
lights is on: DRUM GATE, PAPER FAULT, or PRINT INHIBIT. 

10. Lift TOP OF FORM switch several times to ensure paper is feed- 
ing properly. 

11. Set system, to on-line m.ode by lifting ON LINE/OFFLINE switch 
and verifying that ON LINE indicator lights. At this point, 
printed matter can be aligned with the paper lines by rotat- 
ing the paper vertical adjustment knob. 

For further details on the LPll, refer to the LPll Line Printer 
Manual, DEC-ll-HLPA-D . 
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APPENDIX D 


FORTRAN LOGICAL DEVICE ASSIGNMENTS 


Logical 

Unit 

Number 


Device 

1 

SY: 

System device 

2 

SY: 


3 

SY: 


4 

PR: 

High speed paper 
tape reader 

5 

LP: 

Line printer 

6 

KB: 

Teleprinter 

7 

Sx' : 


8 

BI: 

Batch input device 

3 

KB; 

CFor error logging Dataset 
name CMO) 


Default assignments can be overridden by the $ASSIGN 
statement. E.g. , 

$ASSIGN BI:,3 

assigns the Batch input device to logical unit 3. A READ to BI 
would be specified 


READ C3 , . . . ) 
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APPENDIX E 


PHYSICAL DEVICE NAMES 


Radix-50 


Mnemonic 

Device 

Equivalence 

DC 

RCll Disk 

014570 

DF 

RFll Disk 

014760 

DK 

RKll Disk 

015270 

DT 

DECtape (TCll) 

016040 

KB 

Teleprinter 

042420 

LP 

Line Printer (LPll) 

046600 

MT 

Magtape (TMll) 

052140 

PP 

High-Speed Paper Tape Punch 

063200 

PR 

High-Speed Paper Tape Reader 

063320 

CR 

Card Reader (CRll) 

012620 


NOTE 


a. Device mnemonics may be three letters on 
a particular system. The third letter is 
assigned if there is more than one con- 
troller, e. g. : 

DTA for DECtape controller "A" 

DTB for DECtape controller "B" 

b. The device name may be followed by an 
octal number to identify a particular 
unit when the controller has several 
device units associated with it, e.g.: 

DTI indicates unit 1 under a single 
DECtape control. 

DTAl indicates unit 1 under controller 
A in a multicontrol situation. 
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INDEX 


ASCII, 3-3 

Apostrophe, as special character, 
2-8 

Asynchronous commands, 2-3 


Batch command language, 1-4, 1-6, 
1-14, 2-1 

Batch stream, 1-6, 1-25 
BI, 1-4, 1-10, 1-11, 2-26, 4-3 
Blank suppress, 1-2, B-2 
Brackets, 1-7 
Bypass Et4T, 4-4 


Card reader, A-1 
CDI, 4-1 

Character set, 1-34, 1-35 
CMI, 2-8, 4-1 
CMO, 4-2 

Command string, 1-3, 1-5, 1-9, 1-10 
Command string interpreter, 2-26, 

4-3 

Commands 

$ASSIGN, 1-11, 2-2, 2-8, 4-3, D-1 
BATCH, 1-8, 1-29, 1-30, 2-2, 2-5 
$BEGIN, 2-2, 2-9 
$CHANGE, 2-2, 2-10 
$CPY, 1-15, 1-16 
$DATE, 2-2, 2-11 
$DIR, 1-15, 1-18 
$DUMP, 2-2, 2-12 
$EOD, 1-2, 2-2, 2-13 
$EXECUTE, 1-2, 1-14, 1-15, 1-19 
$FINISH, 1-2, 1-5, 1-13, 2-2, 2-14 
$FORTRN, 1-15, 1-21 
$GET, 2-2, 2-15 
$JOB, 1-2, 1-5, 1-7, 1-13, 2-5 
$KILL, 2-2, 2-17 
$LINK, 1-15, 1-23 
$LIST, 1-15, 1-24 
$MACRO, 1-15, 1-25 
$MESSAGE, 1-32, 2-2, 2-18 
$MODIFY, 2-2, 2-19 
$OTOI, 2-2, 2-20 
$RESTART, 2-3, 2-21 
$RNM, 1-15, 1-26 
$RUN, 1-4, 1-5, 1-13, 2-3, 2-22 
$SAVE, 2-3, 2-23 
$TIME, 2-3, 2-24 
$WAIT, 1-32, 2-3, 2-18, 2-25 
Compile, 1-8 
Concise commands, 1-14 
Console, 1-27 
CONTINUE, 1-32 
CSI2, 4-3 
CTRL/C 

.KI, 1-33 
.TE, 1-33 
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Dataset, 1-6, 2-3, 4-1 
Devices, 1-10, 4-3 
pseudo 1-10, 1-11 
Dump, 1-4, 1-13, 3-2, 3-3 

End-of-file card, 1-2, 1-13, 3-1, B-2 
Entering batch mode, 1-29 
Error messages, 1-30, 1-31, 4-4 


FORTRAN logical units, 1-11, D-1 


Getting Batch on the Air, 1-27 
GO switch, 1-4 


Input 

normal mode, 3-1 
own mode, 3-1 


Job 

abort, 2-17 

name, 1-2, 1-7, 2-5 

switches, 1-8, 2-6 


Keyboard, 

commands printed at, 

Line printer, C-1 

Linker, 

1-6, 1-11 

Linking, 

1-1 

Load module, 1-6 

Log, 1-6 

, 1-8, 1-29, 2-7, 3-2 

MACRO- 11, 

1-8, 1-34, 4-1 

Messages 


error , 

1-30, 1-31 


operator, 1-32 
Monitor, loading the, 1-27 
Multipunch, B-1 


Object module, 1-6, 1-11 
Operating procedures, 1-27 
Operator commands, 1-33 
Output, 3-2 
Overlay, 1-6, 1-12 


PCI, 2-3, 4-2 
PIP, 1-34, 2-27 

Pseudo devices, 1-10, 2-26, 4-3 



Sequence numbers, 1-2 
Switch register, 1-27, 1-28 

Switches 

/DU, 1-4, 1-13 
/E, 1-4 

/GO, 1-3 
/L, 1-4 

/NE, 1-29 
/NL, 1-8, 2-7 
/TI, 1-8, 2-7 
SY, 1-10, 1-11, 2-27, 4-3 
Synchronous commands, 2-3 
System programs, 1-36 

TERMINATE, 2-5 

Terminology, 1-6 

Time limit, 1-8, 1-29, 2-7 

User identification code, 1-7, 2-6 

Word count register, 1-28 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PD P-8 & PDP-12 
Digital Software News for the PDP-ii 
Diaital Softwore News for the PDP— 9/1-5 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office* 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Program Librory in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 




BATCH USER*S GUIDE 
DEC- 1 1- OBUDA-A-D 
MAY 1972 


READER'S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual. 

Please comment on this manual's completeness, accuracy, organization, usability, and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position . 
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